<html>
  <head>
    <title>Folding Plug-in Introduction</title>
    <link rel="stylesheet" href="book.css" charset="ISO-8859-1" type="text/css">
  </head>
  <body>
    <h1>Introduction</h1>
      <p>
        Welcome to the documentation for the <strong>Eclipse Folding</strong> plugin. 
		This plugin enhances code folding in Eclipse IDE, based on and maintained from Coffee-Bytes Code Folding.  
		It allows defining custom foldable regions in Java, XML, and other files using //[start] … //[end] comments, making code more organized and easier to navigate.
      </p>  
	  
	  <h2>Features</h2>
	  <ul>
	    <li>Folding support for <em>classes, methods, field groups, imports, comments, and documentation</em>.</li>
		<li>Custom Region Folding: Define your own folding markers (default [start] / [end]).</li>
	    <li>Deep integration with Eclipse JDT folding preferences to enable/disable folding for specific elements.</li>
	    <li><strong>Fold/Unfold All</strong> and <strong>hierarchical folding/unfolding</strong> commands.</li>
	    <li>Customizable folding strategies in Preferences: Configure in Window → Preferences → Java → Editor → Folding.</li>
	    <li>Preserves Native Folding: Extends Eclipse’s folding system without removing built-in features.</li>
	  </ul>
      
	  <h2>Usage</h2>
	  <h3>Folding/Unfolding in Java Editor</h3>
	  <ul>
	    <li>Use the folding markers (triangles) in the editor margin.</li>
	    <li>Use the <kbd>Source</kbd> menu or shortcuts for batch operations.</li>
	  </ul>
	  <h3>Selecting Folding Provider</h3>
	  <ol>
	    <li>Go to <kbd>Window ▸ Preferences ▸ Java ▸ Editor ▸ Folding</kbd>.</li>
	    <li>Select the <strong>Tlcsdm Java Folding</strong> provider.</li>
	    <li>Enable initial folding for specific elements as needed.</li>
	  </ol>
	  <img src="images/pref.png" alt="Usage">

      <h2>Support/Bugs/Feature Requests</h2>
      <p>
        If you have some thoughts about OpenExplorer, be it a bug report a feature request
        or whatever, use <a href="https://github.com/tlcsdm/eclipse-folding/issues">issues section</a>
        of the project's GitHub page. If the plug-in does not work properly in your
        environment or if you have an idea for a nice feature that would be suitable
        for this plug-in, just go ahead and tell me.
      </p>

      <div style="text-align: center;">
        <a href="02_preferences.html">Preference Page -&gt;</a>
      </div>   
  </body>
</html>
